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ABSTRACT and CONTENTS 

The attached document describes all the currently implemented 
MCALLs on the Sub-Process module of the Model I Basic System. 
It is intended to serve as a system programmer's manual for 
this part of the system. The portions of document PMTSPT/W-2 
which deal with the Sub-process System are rendered obsolete 
by the present document. 
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I Introduction 

The Mo-.lel I Basic System provides facilities with which a 
user may include an arbitrarily constituted collection of 
programs as "sub-processes" of his process, specify relations 
which are to subsist among the sub -processes, and transfer . 
control from one sub-process to another. The Basic System 
module which implements these facilities is called the Model 
I Sub-Process System. Detailed descriptions of the MCALLs 
through which the user accesses the Sub-process System are 
given below, following some explanatory material. 
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II The Sub-?rocess Table 

The sub-processes of a process are defined by entries in a 
large table, called the Sub-Process Tab!;; (SPT), which oc- 
cupies a considerable portion of the process' Context Block. 
SPT can contain as many as eight entries . One or two of 
these will normally hold definitions of system sub-processes, 
leaving coom for six or seven user-selected programs. 

Figure 1 shows the format of an entry in the Sub-Process 
Table. Of' the forty-two words, twenty-four are used to de- 
fine the sub-process' address space, which may be as large as 
128K words. The fields of the entry are given the following 
significance . 

NAME: 

This 9-bit field plays two roles. As an identifying mark 
for the sub-process, it is written into the lock fields of 
objects, such as ICT, OFT, and PMT- entries, which belong to 
the sub-process. It also functions as a "control lock" on 
the SPT entry itself, protecting it from modification by 
other sub-processes which are not properly authorized. NAME 
always has exactly one bit set — in fact, its value is 2 n , 
where n is the index of the SPT entry. 

CALL MASK: 

This is another 9-bit field, whose function is to limit "ac- 
cess" to the sub-process, that is, to prevent it from being 
called by unauthorized sub-processes. The contents of CM 

bears no relation to the SPT index or to NAME. It may be 
any collection of bits. 
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KEY: 

KEY is yet another 9-bit field. Its function is to unlock 
locks, Such as the NAME and CALL MASK of SPT entries and the 
access and control locks of ICT, OFT, and PMT entries. A 
KEY fits a lock if the bit-wise AND of it with the lock is 
non-zero. If a sub-process' KEY fits the lock on some ob- 
ject, the sub-process is authorized to perform certain re- 
stricted operations on the object. In particular, if the 
KEY of a sub-process fits the NAME of an SPT entry, the sub- 
process is authorized to modify the entry. If its KEY fits 
the entry's CALL MASK it is authorized to call the sub-pro- 
cess defined by the entry. 
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FATHER: 

When one sub-process creates another sub-process, the SPT 
index of the creating sub-process is put into the FATHER 
field of the new sub-process ' SPT entry. The restrictions 
(described below) on subsequent modifications of the FATHER 
field guarantee that these f ields ■ define a tree in the Sub- 
process Table. This "FATHER tree" establishes relations of 
responsibility among the sub-processes. If, for example, a 
sub-process causes a trap which it is not able to deal with, 
its FATHER is given a chance to handle it. If it declines, 
then its FATHER is called, and so on, until the "root" of 
the FATHER tree is reached. The root will normally be a sys- 
tem sub-process capable of handling any abnormal situations 
which may arise. The FATHER field of a root is always zero. 
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UTILITY SUB-PROCESS: 

Sub-processes may run in the User Ring of the Model I ad- 
dress space or in the Utility Ring. Since these rings are 
disjoint and since the CPU provides hardv/are for communi- 
cating between the -two rings, it is feasible and efficient 
to allow one sub-process to reside in the Utility Ring while 
another occupies the User Ring. It is intended that most 
programs be run as user-ring sub-processes and that the Util- 
ity Ring normally contain a standard system program (the 
Model I Utility System) with which the user-ring sub-processe 
can communicate through the hardware UCALL instruction. • 

The USP field of an SPT entry for a user-ring sub-process 
contains the SPT index of the sub-process which is to reside 
in the Utility Ring when the sub-process is active. For con- 
venience, the USP field of a utility ring sub-process' -SPT 
entry always contains the index of the entry itself. 

RING: 

This field indicates whether the SPT entry describes a user- 
ring sub-process or a utility-ring sub-process. A value of 
means user-ring, 1 means utility-ring. 

ENTRY POINT: 

in order to be run as a sub-process a program must contain a 
specification of its entry points. This is expected to take 
the form of an array of pointers to function descriptors for 
the functions that eire designed to be called by other sub- 
processes. The absolute address of the descriptor for this 
array is ke pt in the EP f ield of t-ho nib-pmpnc; 1 — S?T entry. 




The first two pointers in the array are assumed to point to 
a tr tp-handling function and an interrupt-handling function, 
respectively . 

ENTRY G-REGISTER: 

This field contains an 18-bit number which will be loaded 
into the CPU's G-register whenever control is transferred to 
the sub-process by any of the MCALL ' s described below. 

STATUS BITS: 

The bits in this field specify the privileges and certain 
operating characteristics of the sub-process. Details are 
given in Figure 2. 

TRAP MASK: 

The bits in TM arm/disarm the various traps which may be 
generated in the sub-process structure. Figure 3 gives de- 
tails of this field. 



STATUS CONTROL BITS: 

This field has the same internal format as the STATUS BITS 
field (see Figure 2) . A sub-process with bits set in SCB 
is authorized to set and reset the corresponding bits in SB. 

TRAP CONTROL MASK: 

TCM has the same relation to TM as SCB has to SB . A sub- 
process can set/reset bits in TM only if it has the corres- 
ponding bits set in TCM. 
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TEMPORARY ACCESS KEY: 
USER NUMBER: 
PERMANENT ACCESS KEY 1: 
PERMANENT ACCESS KEY 2: 

These four 48-bit fields are used to hold access keys for 
accessing objects through the Basic File System. Normally 
UNO will contain the User Number of the user to which the 
sub-process belongs and TAK will hold whatever key is being 
currently used by the sub-process. PAKl and PAK2 are pro- 
vided for saving arbitrary access keys. 

USPUN: 

This 48-bit field is intended to contain the File System's 

Unique Name for the file on which the sub-process' Utility 

Sub-Process resides. If the sub-process is a utility-ring 

sub-process, this field is the utility program's own Unique 

Name. 
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READ-ONLY BITS: 

These 64 bits specify the read-only status of the 64 pages 
in the sub-process address space. They are copied, along 
with the corresponding PMT indices from the MAP, into the 
process* map when the sub-process is made active. 

.PMT INDICES (MAP) : 

This string of 64 8-bit bytes specifies the sub-process' 
address space in terms of pointers to page names in the pro- 
cess Memory Table. Only the first 32 bytes of the MAP (and 
the first 32 READ-ONLY BITS) have significance for utility- 
ring sub-processes. 
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Ill The Sub-Process Call Stack 

The Sub-Process System includes MCALLs by which one sub- 
process may call a function in another sub-process. In or- 
der to allow the called function to return control (by an- 
other MCALL) to the sub-process which ca±led it, the system 
must save some information about the state of the caller. 
This information consists primarily of the SPT index of the 
caller and the values to which the p, L, and G registers 
should be set on return. 

Figure 4A shows the format of an entry in the table, called 
the Sub-Process Call Stack (SPCS), in which this sub-pro- 
cess return descriptor is saved. A sub-process acquires an 
entry on SPCS (at "stack level -1") when it becomes active, 
. that is, when it is called. At this time, the sub-process* 
SPT index is put in the entry and certain other fields are 
initialized. When the called sub-process itself calls an- 
other sub-process, its P, L, and G registers are saved in 
the entry (which becomes stack level 0) . 

The fields of an SPCS entry hold the following information. 

NIS: 

This flag is set when the sub-process (in its incarnation 
at the stack level described by this entry) makes itself 
non-interruptable . Non-interruptability is described in 
document IWS/W-11 on the "Interrupt and Wake-up System.' 1 
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NIC: 

This flag is set when the SPCS entry i<-: acquired if the im- 
mediately preceding entry has either Nl S or NIC set. It 
means that the sub-process being activated is non-interrupt- 
able as a result of being called from a non-interruptable 
sub -process. 

SPNO:- 

The SPT index of the sub-process being called is recorded 

here at the time of the call. 

CAKF: 

If this flag is set in an SPCS entry, the called sub-process 
is allowed to copy the TEMPORARY ACCESS KEY of its caller 
into its own SPT entry. The calling sub-process specifies 
at call time the value to be given to CAKF. 

CC: 

The Basic System code which actually passes control to the 
sub-process being called may generate any of a number of 
traps without completing the transfer. In some cases it 
may be desirable to call another sub-process to handle the 
trap and then to try to pass control again when the trap- 
handling function returns. The Basic System could save its 
own P, L, and G registers in the SPCS entry and just resume 
execution at the point they define. This would probably 
lead to disaster, however, since there is no way to insure 
that the sub-process called to handle the trap will, for 

example, preserve the central registers. This problem is 
s olved by saving in the stack entry enough information to 




allow the entire function which transfers control to the 
sub-process to be re-executed. This information is saved 
in the fields EPNO, PARI, and PAR2 shown in figure 4B ; • 
The CC flag is reset when this information is saved and set 
when the system detects that the call has been successfully 
completed. (CC stands for "Call Completed.") 

PC, LR, GR: 

The p-counter and L and G registers of the sub-process are 

saved here when it calls another sub-process. 

NIET: 

This 47-bit field holds the real time at which non-inter- 
ruptability is to expire. It is loaded from the corres- 
ponding field of the immediately preceding stack entry at 
call time. If the sub-process is interruptable, NIET is 
zero . 

EPNO (Figure 4B) : 

When CC=0, this field holds an index into the called sub- 
process' sub-process entry point vector. It has no signi- 
ficance when CC=1 . 



PARI (Figure 4B) : 

When CC=0 and EPNO=0 this holds the trap number of the trap 
which the .sub-process is being called on to handle. When 
CC~0 and EPN0=1 this field holds the interrupt number of 
the interrupt which caused the sub-process to be called. 
It has no meaning in any other cases. 
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PAR2 (Figure 4B) : 

This field only has meaning in the case ::c=0, EPNO=0. It 
then holds the parameter being passed tc the called sub- 
process' trap-handling function. 
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IV MCALLs on the Sub-process System 

The following pages describe each of the MCALLs on SPS by- 
giving 

(1) the SPL declaration for the function. 

(2) the values returned when the function succeeds, 

(3) the conditions under which the function will fail and 
the error codes and error message numbers returned in 
each case, and 

(4) a description of what the function does. 

The function descriptions make reference to the following 
parameters. 



Name 



NSPTE 



Value 



8 



LSPTE 



NSPCSE 



42 



16 



LSPCSE 



USER'EP 



USER 'EG 



MAXEPNO 



8 
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Significance 



The number of elements in the Sub- 
Process Table (SPT) and therefore 
the maximum number of sub-processes 
which may co-exist in a process. 

The number of words occupied by 
each SPT element. 

The number of entries in the Sub- 
Process Call Stack array and there- 
fore the maximum depth to which 
sub-process calls may be stacked. 

The number of words in an SPCS en- 
try. 

The standard location of the sub- 
process entry point array descrip- 
tor for a user-ring sub-process. 

The standard setting of the G reg- 
ister to be used when entering a 
user-ring sub-process. 

The maximum acceptable index into 
a sub-process' entry point array. 
This allows for 1024 entry points, 
the first two of which are reserved 
for trap and interrupt functions. 
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NORMAL ' SB 



NORMAL ' TM 







NORMAL ' SCB 



NORMAL ' TCM 



The value to which the STATUS BITS 
word of an SPT entry is initialized 
The value is DPNIC - DCWSO + DDWSO 
-r DPNOD. (See Figure 2.) 

The value to which the TRAP MASK 
word of an SPT entry is initialized 
A sub-process i s expected to arm 
those traps it wishes to handle. 

The value to which the STATUS CON- 
TROL BITS word of an SPT entry is 
initialized. The value is DPNIC + 
DCWSO + DDWSO + DPNOD. (See Fig- 
ure 2 . ) 

The value to which the TRAP CON- 
TROL MASK of an SPT entry is ini- 
tialized. The value is MACC + PRO 
+ PNIM + PNIC + PI + TI + BLL + 
ILIM + PNOD + DWSO + CWSO + NEP -f 
DMRD + NILE + SPCSO + PMTO . (See 
Figure 3 .) 



The descriptions also make reference to the variables CSP 
and SPCSL. The first of these is the SPT index of the cur- 
rently active sub-process, which is imagined to have made 
the call to the function being discussed. The second is 
the SPCS index of the stack entry for the currently active 
sub-process. 

Many or the functions take an SPT index as one of their ar- 
guments. In every such cas-e, -1 is an acceptable value for 
this argument. With the single exception of CREATE' SP, -1 
'supplied as an SPT index is taken to mean CSP, the index of 
the entry for the current sub-process. 

Every one of these MCALLs has at least one failure return. 
The failure returns uniformly return two integer quantities. 
The first is a character constant consisting of three 8-bit 
characters which are intended to be suggestive of the nature 



( c; 
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of the e.-ror condition causing the failure. These error 
codes anc the phrases they are intended to suggest are listed 
in Append-:' B. The second argument is an index into an ar- 
ra-; 3f c T 's * ' ??. error messacxes which oro" r ice a rr"re complete 
description of the 'error. Appendix C lists the error mes- 
sage numbers which- appear in the SPS MCALLs with tentative 
specifications of the strings to which they will correspond. 

A few terms reed definition: 

An SPT entry is free if its NAME field is 0. 

A sub-process is called a utility sub-process if it is de- 
signed to run in the Utility Ring. 

A sub-process is called a user sub-process if it is 
designed to run in the User Ring. 

The ancestors of a sub-process are all the sub-processes 
which appear below it in its FATHER tree. 

The root of a FATHER tree is the (unique) sub -process in the 

tree which has no FATHER. 

♦ 

One sub-process controls another if its KEY includes the . 
other's NAME. 

One sub-process has access to another if the bit-wise AND 
of its KEY with the other's CALL MASK is non-zero. 
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Creating and Destroying Sub-Processes 

A sub-process creates another one by making m entry in the 
, Sub-Piucesd L'abie. The first step in making an SPT entry 
i is to call the function CREATE ' SP . This function "acquires" 
a free SPT entry and initializes it to certain standard 
.-alues. If these standard values are what are desired, it 
c\ly remains for the creating sub-process to specify the new 
su-\ -process ' address space (with SET'MAP). if necessary, the 
standard sub-process definition may be modified, by the 
use .vf SET' SPT 'FIELD . It will be noticed that there is no 
way t v create a utility sub-process with the MCALLs described 
in thi v document. This limitation will be removed shortly. 

A sub-process which controls another may delete it (remove 
its definition from SPT) by the use of the function 
DESTROY ' S *•' . 
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CREATE' SP - Acquire and Initialize an SPT Entry 



(C 



Declaration: 

FUNCTION CREATE ' SP { SPTX) , FRETURN, MONITOR <- 90; 
Success Return: 

RETURN SPTX; 
Failure Returns: 

(1) FRETURN( 'SPI', 138) unless 

(a) 1 £ SPTX £ NSPTE, or 

(b) SPTX = -1. 

(2) FRETURN( ' SPF ' , 103) if 

(a) SPTX = -1 and there are no free SPT entries, or 

(b) SPTX ^ -1 and SPT[SPTX] is not free. 
Action: 

If SPTX = -1, SPT is searched for a free entry and 
the index of the first one found is assigned to SPTX. 

SPT (SPTX] is cleared, and then initialized as follows 

(1) NAME <- 2TSPTX 

(2) CM «- NAME(CSP) 

(3) KEY - NAME 

(4) FATHER *- CSP 

(5) USP * USP(CSP) 

(6) RING <- 

(7) EP *- USER'EP 

(8) EG *- USER' EG 

(9) SB <- NORMAL* SB AND (SCB(CSP) AND SB(CSP)) 
(10) TM <- NORMAL* TM AND (TCM(CSP) AND TM(CSP) ) 
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CREATE" SP (continued) 



C C 
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(11) SCB <- NORMAL 'SCB AND SCB(CSP) 

(12) TCM •*- NORMAL' TCM AND TCM(CSP) 

(13) UNO «- UNO(CSP) 

(14) USPUN <- USPUN(CSP) 

SPT[SPTX] is incorporated into the sub-process control 
structure by merging its NAME into the KEYs of all its 
ancestors . 

SPTX is returned as the value of this MCALL. 



• r 



t „_ 

c 



CC 



p/e-n.r 

MISPS/M-7 



page 
19 



DESTROY" SP - Delete the Contents of an SPT Entry 
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Declaration: 

FUNCTION DESTROY* SP(SPTX) , FRETURN, MONITOR --91; 
Succefjs Return: 

RETURN, or 

SP' RETURN in the case SPTX = CSP . 
Failure Returns: 

(1) FRETURN( 'CSE', 162) if SPTX = CSP and the Sub-process 
Call Stack is empty. 

(2) FRETURN( ' SPI ' , 138) unless 1 £ SPTX ' £ NSPTE . 

(3) FRETURN ( *SPC', 160) unless SPTfSPTX]' is controlled 
by CSP. 

(4) FRETURN( ' SPS ' , 161) if SPTfSPTX] appears on the 
Sub-Process Call Stack at any level except the very 
top . 

Action: 

If SPTX = -1, it is taken to refer to CSP. 

NAME (SPTX) is removed from all CM, KEY, and USP 
fields of SPT entries and from all Access Locks and 
Control Locks in ICT, OFT, and PMT. Any entries in ICT, 
OFT, and PMT whose Control Locks become zero as a result 
of the removal of NAME (SPTX) are DELETEd. 

Any SPT entry which has SPTX as its FATHER is given 
FATHER (SPTX) instead. . * 

SPTfSPTX] is cleared and the MCALL returns, either 
in the normal manner, or through SP'RETURN, in the special 
case where SPTX = CSP. 



■cc 



p/c-n.r 

MISPS/M-7 



page 
20 



c 



Passing Control Between Sub-Processes 

This section describes the MCALLs by which one sub-process 
may pass control to another. The general procedure is for 
the current sub-process to call the Basic System and for the 
Basic System to then call a specially prepared function 
(designated as an SP* ENTRY) in the other sub-process. The 
MCALLs SP'CALL, SP'JUMP, and SP'BRANCH allow the calling 
sub-process to specify the sub -process to be called and the 
point at which it is to be entered. The sub-process called 
as a result of SP'TRAP or TRAP'RETURN is determined by the 
calling sub-process' FATHER tree and the TRAP MASKs therein 
and is not under control of the caller. There is one 
additional mechanism, the inter-process interrupt system, 
which causes control to be passed to a new sub-process. This 
mechanism is described in document IWS/W-11 . 

With the exception of SP'TRAP and its variant, TRAP'RETURN, 
the functions about to be described do not allow for the 
passing of arguments from one sub-process to another. A 
later version of the Sub-Process System will have this 
deficiency removed. 
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SP'CALL - Call a Sub-Process 

Declaration: 

FUNCTION SP'CALL(SPTX, ENTRYNO, FLAG), FRETURN, 

MONITOR <- 111; 
Success Return: . . 

This MCALL does not return to its caller if it 
succeeds. Control will be returned to the caller when 
the called sub-process returns (with SP ' RETURN). 
Failure Returns: 

(1) FRETURN('SPI', 138) unless 1 £ SPTX £ NSPTE . 

(2) FRETURN( 'EPN', 173) unless 2 £ ENTRYNO ^MAXEPNO. 

(3) FRETURN( 'SPA', 140) unless CSP either controls 
SPT[SPTX] or has access to it. 

(4) FRETURN( 'RCS', 141) unless there is sufficient room 
on the Sub-Process Call Stack to record the call 

of SPTX and a subsequent series of calls on all 
the sub-processes which are ancestors of it. This 
is to insure that any software trap generated by 
SPTX can be handled in an orderly manner. 

(5) FRETURN( 'ARG', 172) unless FLAG is or 1. 
Action: 

This MCALL transfers control to the sub-process 
defined by SPT[SPTX] by calling the ENTRYNO th function 
in that sub-process' SP' ENTRY transfer vector. If 
SPTX = -1, the sub-process called is the currently active 
one, CSP. No arguments are passed, but the central ..- 
registers are preserved across the call. The final 
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SP'CALL (continued) 



(C 



argument^ FLAG, determines whether the called sub-process 
will be allowed to execute the special function COPY'TAK. 
If FLAG = 1. execution will be allowed; if it is 0, 
execution will be illegal. 

The P, L, and G registers of the calling sub-process 
are saved so that execution can be continued when the 
called sub-process returns (with SP ' RETURN or an 
equivalent) . 

If the calling sub-process is non-interruptable with 
a non-interruptability expiration time, NIET, the called 
sub-process is made non-interruptable with the same 
value for NIET. 
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SP'JUMP - Jump to a Sub-Process 
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Declaration: 

FUNCTION SP'JUMP(SPTX, ENTRYNO, FLAG), FRETURN, 

MONITOR <- 112; 
Success Return: 

This function does not return to its caller if it 
succeeds. 
Failure Returns: 

(1) FRETURN ( 'SPI', 138) unless 1 £ SPTX £ NSPTE . 

(2) FRETURN ( 'EPN', 173) unless 2 £ ENTRYNO £ MAXEPNO . 

(3) FRETURN ( 'SPA', 140) unless CSP either controls 
SPT[SPTX] or has access to it. 

(4) FRETURN ( 'RCS ' , 141) unless there are as many unused 
Sub-Process Call Stack entries as there are 
ancestors of SPTX. 

(5) FRETURN ( 'ARC, 172) unless FLAG is or 1 . 
Action: 

Like SP'CALL, SP'JUMP transfers control .to -sub^proeess 
SPTX by calling the ENTRYNO*-* 1 function in its array of 
SP* ENTRY functions. As usual, SPTX = -1 is taken to 
mean the current sub-process, CSP. The central registers 
are passed unchanged from the calling sub-process to the 
one being called, but no other arguments are transmitted. 

SP'JUMP differs from SP'CALL in that no provision 
is made for the called sub-process to return to its 
caller. In fact, the calling sub-process completely 
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SP ' JUMP ( continued) 

disappears from the Sub-Process Call Stack. It will 
look to the called sub-process as if it were called by 
the caller of CSP instead of CSP itself. 

The called sub-process will be allowed to execute. 
COPY'TAK iff the calling sub-process was authorized to 
do so and the value of FLAG is 1. 

If the caller of the calling sub-process is non- 
interruptable with non-interruptability expiration time 
NIET, the called sub-process is made non-interruptable 
until the same time. 
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SP'TRAP - Generate a Soft-ware Trap 



C 



C 



Declaration: 

FUNCTION SP'T?Jl?( TRAPNO, PARAMETER, FLAG), FRETURN, 
• •- * MONITOR -e 113; 

Success Return: 

This function doesn't return to its caller if it 
succeeds. Control will return to the caller when the 
sub-process which handles the trap executes an SP'RETURN. 
Failure Returns: 

(1) FRETURN ( 'TNO', 139) unless £ TRAPNO £ 23. 

(2) FRETURN( 'ARC, 172) unless FLAG is 0. or 1. 
Action: 

Starting with sub-process CSP and following its 
FATHER chain in SPT, we search for an SPT. entry with 
bit TRAPNO set in its TRAP MASK (TM) . Let SPTX be 
the SPT index of the first such entry, or the root of 
CSP's FATHER tree if there are none. 

Control is transferred to sub-process SPTX by calling 
its SP ' TRAP ' ENTRY function, which is the th entry in its 
array of SP ' ENTRY functions. TRAPNO and PARAMETER are 
passed by the call and the central registers are trans- 
mitted unchanged. 

The p, L, and G registers of the calling sub-process 
are saved, so that execution can be resumed when the 
trap-handling function returns (with SP'RETURN). • 

If FLAG = 1, the sub-process which fields the trap 
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SP'TRAP (continued) 



(L 



will be authorized to execute COPY'TAK. If FLAG = 0, it 
will not. 

The algorithm for finding the sub-process to which 
the trap is to be sent is in reality slightly more 
complicated than what was described above. in searching 
down the FATHER tree, we ignore SPT entries whose distance 
from the "root of the tree is greater than the number 
of free Sub-process Call Stack entries. In particular, 
this means that if there is only one free SPCS entry, 
we always call the root of the tree. 

If the sub-process which generates the trap is non- 
interruptable with non-interruptability expiration time 
NIET, the sub-process which fields the trap is made non- 
interruptable until the same time. 

When the Monitor wants to reflect a ring-independent 
hardware trap to a sub-process, it uses SP'TRAP. 
Primarily for this reason, bit TRAPNO in the TRAP MASK 
of the called sub-process is reset before the call is 
made. 
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TRAP'RETURN - Pop up the Sub-Process Call Stack and Generate 

a Software Trap 
Declaration: 

FUNCTION TRAP' RETURN (TRAPNO, PARAMETER, FLAG), FRETURN, 

MONITOR <r 114; 
Success Return: 

This MCALL doesn't return to its caller if it succeeds 
Failure Returns: 

(1) FR£TURN( 'TOO', 139) unless £ TRAPNO £ 23. 

(2) FRETURN( 'ARG', 172) unless FLAG is or 1. 

(3) FRETURN( 'CSE', 152) if the Sub-Process Call Stack 
• is empty. 

Action: 

This MCALL is provided to allow a sub-process to 
convert a call on itself into a software trap. The 
system deletes all record of the call and proceeds as if 
the sub-process which made the call had instead executed 
an SP'TRAP. See the description of SP'TRAP for the 
details of the action taken. There is one small anomaly. 
The sub-process which gets called to handle the trap is 
given authority to use COPY'TAK iff the current sub- 
process has that privilege and FLAG is 1. 
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SP'BRANCH - Branch into a Sub-Process 
Declaration: 

FUNCTION SP' BRANCH (SPTX, PC, LREG, GREG, FLAG), FRETURN, 

MONITOR <- 115; 
Success Return: 

This function doesn't return to its caller if it 
succeeds, but the sub-process into which it branches 
may return to the calling sub-process by executing an 
SP' RETURN. 
Failure Returns: 

(1) FRETURN ( 'SPI ', 138) unless 1 £ SPTX £ NSPTE . 

(2) FRETURN ( 'SPC', 142) unless CSP controls SPT[SPTX] . 

(3) FRETURN ( 'RCS ' , 141) unless there is enough room on 
SPCS to record calls to SPTX and all its ancestors. 

(4) FRETURN ( 'RNG', 173) unless PC, LREG, and GREG" are- aadqesse 
in the ring specified by the RING field of SPT[SPTX] . 

(5) FRETURN ( 'ARG', 172) unless FLAG is or 1. 
Action: 

Control passes to sub-process SPTX at location PC. 
The L and G registers are set from LREG and GREG. The 
• central registers are passed unchanged. As usual, 
SPTX = -1 is taken to refer to the current sub-process, 
CSP. 

With the one difference that the new sub-process 
is simply entered at a specified location instead of 
being called through one of its SP'ENTRY functions, this 
MCALL is identical with SPlCALL. 
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SP* BRANCH (continued) 



Whether the "called" sub-process will be allowed to 
execute COPY'TAK is determined by the value of the final 
argument, FLAG. • A value of 1 allows execution, a value 
of forbids it. 

The calling sub-process 1 P, L, and G registers are 
saved so that the called sub-process may return control 
to it by executing an SP' RETURN. 

The non-interruptability status of the calling sub- 
process is carried over to the new sub-process. That is, 
if the calling sub-process is non-interruptable until 
a certain time, NIET, the new sub-process is made non- 
interruptable until the same time. 
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SP 'RETURN - Return to Calling Sub-process 



Declaration: 

FUNCTION SP' RETURN ( ), FRETURN, MONITOR «- ±16; 
Success Return: 

This MCALL doesn't return to its caller if it succeeds 
Failure Returns: 

(1) FRETURN( 'CSE', 152) if the Sub-process Call Stack 
is empty. 
Action: 

A sub-process which has been called as the result of 
SP'CALL, SP'JUMP, SP'TRAP, TRAP' RETURN, or SP 'BRANCH 
can return to the sub-process which called it by 
executing SP'RETURN. Control is returned to the old 
sub-process with p, L, and G restored to the values 
which were saved when the current sub-process was called. 
The central registers are preserved over the return. 
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JUMP'RETURN - Return to a Specified Level in the Sub-Process 
Call Stack 



Declaration: 

FUNCTION JUMP' RETURN ( STKL) , FRETURN, MONITOR «- 117; 
Success Return: 

None, unless STKL = -1 . This rather strange case is 

discussed below. 
Failure Returns: 

(1) FRETURN( , CSL*, 153) unless -1 £ STKL £ SPCSL -1. 

(2) FRETURN( *SPC ' , 154) unless the calling sub-process, 
CSP, controls all the sub-processes which are 
entered in the Sub-Process Call Stack at levels -1 
through STKL. 

Action: 

This function pops the Sub-process Call Stack up to 
level STKL and returns control to the sub-process 
whose SP'RETURN descriptor (p, L, and G) was stacked^ 
at that level. The central registers are preserved by 
this function. If STKL = -1, the function just returns 
to its caller. Note that the function can fail even 
in this case if the calling sub-process doesn't control 
its own SPT entry. 
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MARK' CALL - Record a Function Call on the Sub-Process Call 
Stack 

Declaration: 

FUNCTION MARK' CALL (PC, LREG, GREG), FRETURN, 

MONITOR <- 118; 
Success Return: 

RETURN; 
Failure Returns: 

(1) FRETURN( 'RCS', 141) unless there is at least one 
more free Sub-process Call Stack entry than there 
are ancestors of CSP. 

(2) FRETURN( 'RNG', 155) unless PC, LREG,.-< and GREG? are 
all addresses in a ring accessible from the ring 
from which the" MCALL was made. 

Action: 

This function is provided primarily to allow utility- 
ring functions which have been entered by a UCALL to 
record the call on the Sub-process Call Stack as if~:they 
had been entered with SP'CALL* 
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READ'SPT - Read an SPT Entry 



X 



Declaration: 

FUNCTION READ 'SPT (SPTX, Array SPTE, Scalar NW) , FRETURN, 

MONITOR «- 95; 
Success Return: 

RETURN; 

Failure Returns: 

(1) FRETURN ( 'SPI', 138) unless 1 £ SPTX £ NSPTE . 
Action: 

If SPTX = -1, CSP is used in its place. 
The first M words of SPT [SPTX] are copied into the 
caller's array, SPTE, where M is the minimum of LSPTE 
and NW. 
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Declaration: 

FUNCTION READ' SPCS (STKL, Array SPCSE) , FRETURN, 

MONITOR <- 96; 
Success Return: 

RETURN; 

Failure Returns: 

(1) FRETURN( 'CSL', 153) unless -1 £ STKL £ SPCSL -1. 

Action: 

STKL is interpreted as a stack level number, not as 
an SPCS index. Stack level -1 refers to" the SPCS entry 
for the current sub-process, stack level to the entry 
for the sub-process which called it, stack level 1 
to that for its caller, and so on. The LSPCSE words of 
the SPCS entry selected by STKL are copied into the 
caller's array, SPCSE. The CC field of the entry returned 
determines which of figures 4A and 4B should be used 
to interpret it. CC = refers to figure 4b, CC = 1 to 
figure 4A. 
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READ 'SPT' FIELD - Read Selected Field of an SPT Entry 

Declaration: 

FUNCTION READ' SPT' FI ELD (SPTX, FLDNO) , FRETURN, MONITOR^97; 
Success Return: 

RETURN FLD; where FLD is the contents of the field speci- 
fied by SPTX and FLDNO. 
Failure Returns: 

(1) FRETURN( ' SPI ' , 138) unless 1 £ SPTX ^NSPTE. 

(2) FRETURN( 'ARC, 165) if FLDNO is not an acceptable field 
specification (see below) . 

Action: 

SPTX is used to select an SPT entry. If SPTX = -1, the 
entry selected is the one which describes the currently 
active sub-process, CSP . 

FLDNO selects one of 12 fields within SPT [SPTX], in ac- 
cordance with the following table. 



FLDNO 






or 


NAM' 


1 


or 


CM' 


2 


or 


KEY' 


3 


or 


FTH* 


4 


or 


USP' 


5 


or 


RNG' 


6 


or 


EP' 


7 


or 


EG' 


8 


or 


'SB' 


9 


or 


•TM' 



Field Selected 

NAME 

CALL MASK (CM) 

KEY 

FATHER 

UTILITY SUB-PROCESS (USP) 

RING 

ENTRY POINT (EP) 

ENTRY G-REGISTER (EG) 

STATUS BITS (SB) 

TRAP MASK (TM) 
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READ 1 SPT' FIELD (continued) 

10 or 'SCB' 

11 or 'TCM' 



STATUS CONTROL BITS (SCB) 
TRAP CONTROL MASK (TCM) 



READ 'SPT 'FIELD returns the contents of the selected 
field as its value. 
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SET' SPT 'FIELD - Set the Value of a Specified Field of an SPT 

Entry- 
Declaration: 

FUNCTION SET' SPT 'FIELD( SPTX, FLDNO, DATA) , F RETURN, 

MONITOR <- 98; 
Success Return: 

RETURN; 
Failure Returns: 

(1) FRETURN( 'SPI', 138) unless 1 £ SPTX £ NSPTE . 

(2) FRETURN( ' SPC ', 143) unless SPT[SPTX] is controlled by 
the current sub-process, CSP . 

(3) F RETURN ( 'ARC , 167) if FLDNO is not an acceptable 
field specification. See the description of 
READ 'SPT 'FIELD for a list of acceptable values of 
FLDNO and the SPT fields they select. 

(4) In addition to the three general errors just described, 
there are others having to do with the validity of 
DATA as a new value for the field selected by FLDNO . 
We list these for each of the 12 fields which FLDNO 
may select. 

(a) NAME - 

(1) FRETURN ( ' MNM ' , 168) unless DATA is identical 
with the current NAME field of SPT [SPTX] . 

(b) CALL MASK (CM) - 

Any value of DATA is acceptable. 

(c) KEY - 

(1) FRETURN ( 'SPC ' , 148) if DATA contains any bits 
which are in neither the KEY of SPTX nor the 
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SET' SPT' FIELD (continued) 

KEY of CSP (i.e., if CSP is trying to give 
SPTX control of SPT entries which it does not 
itself control) . 

(d) FATHER - 

(1) FRETURN( 'SPI ', 138) unless 1 £ DATA £ NSPTE . 

(2) FRETURN( * SPC ', 149) unless SPT[DATA] is con- 
trolled by CSP . 

(3) FRETURN( 'FHL' , 150) if 

(a) DATA = SPTX, or 

(b) SPTX is an ancestor of DATA. 

(4) FRETURN( 'RCS' , 151) if SPTX appears on the 
Sub-Process Call Stack at a level, CSL, such 
that the number of ancestors of DATA is greater 
than NSPCSE - (CSL + 3) . 

(e) UTILITY SUB-PROCESS (USP) - 
(1) FRETURN( 'MUS' , 170) unless DATA is identical 

with the current USP field of SPT [SPTX] . 

(f) RING - 
(1) FRETURN( 'MRG' , 171) unless DATA is identical 

with the current RING field of SPT [SPTX] . 

(g) ENTRY POINT (EP) - 
(1) FRETURN ( ' RNG ' , 157) unless DATA is an address 

in the ring specified by the RING field of 
SPT [SPTX] . 
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SET* SPT* FIELD (continued) 



C 



(h) ENTRY G-REGISTER (EG) - 

(1) FRETURN (' RNG ' , 157) unless DATA is an address 
in the ring specified by the RING field of 
SPTfSPTX] . 

(i) STATUS BITS (SB) - 

(1) FRETURN ( ' MSB ' , 144) if the exclusive or of 
DATA with the SB field of SPT[SPTX] is not a 
subset of the SCB field of SPT [CSP]. This 
means that CSP cannot set or reset a status 
bit which it doesn't control. 

(j) TRAP MASK (TM) - 

(1) FRETURN ( 'MTM' , 147) if the exclusive or of 
DATA with the TM field of SPT[SPTX] is not a 
subset of the TCM field of SPT [CSP] . This 
means that CSP cannot set or reset a trap bit 
which it doesn't control. 

(k) STATUS CONTROL BITS (SCB) - 

(1) FRETURN( 'MSC ' , 145) if the exclusive or of 

DATA with the SCB field of SPT[SPTX] is not a 
subset of the SCB field of SPT[CSP]. This 
prevents CSP from modifying status control 
bits it doesn't control. 

(1) TRAP CONTROL MASK (TCM) - 

(1) FRETURN ( 'MTC ' , 146) if the exclusive or of * 

DATA with the TCM field of SPT[SPTX] is not a 
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SET* SPT" FIELD (continued) 



C 



subset of the TCM field of SPTTCSP] . The ef- 
fect of this is to prohibit CSP modifying 
trap control bits it doesn't control. 
Action: 

SPTX is used to select an entry in SPT. As with most 
of the MCALLs which take an SPT index as an argument, 
SPTX = -1 is taken to refer to the SPT entry which defines 

the currently active sub-process, CSP. The second argu- 
ment, FLDNO, specifies a field within SPT [SPTX] in exactly 
the same way as is detailed in the description of 
READ 'SPT 'FIELD. The third argument, DATA, is copied into 
the selected field of SPT [SPTX], if the relevant validity 
checks succeed. 
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READ' MAP - Read the Map of an SPT Entry 

Declaration: 

FUNCTION READ 'MAP (SPTX, String MAP), FRETURN, MONITOR <- 99; 

Success Return: 
RETURN; 

Failure Returns: 

(1) FRETURN( *SPI', 138) unless 1 £ SPTX £ NSPTE . 

Action: 

If SPTX = -1, this MCALL reads the MAP of CSP. 
Let ML = 32 if SPTX is a utility sub-process or 64 if 
it is a user sub-process, and let M be the minimum of ML 
and LENGTH (MAP) . This function writes the first M bytes 
of MAP from the first M PMT indices in SPT [SPTX] and its . 
first M READ ONLY BITS. Twelve bit quantities are written 
into each byte. The last 8 bits are a PMT index and the 
first bit a READ ONLY BIT. 
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SET' MAP - Set the Map of an SPT Entry 

Declaration: 

FUNCTION SET'MAP(SPTX, String MAP), FRETURN, MONITOR <- 100; 
Success Return: 

RETURN; 
Failure Returns: 

(1) FRETURN ( 'SPI 1 , 138) unless 1 £ SPTX < NSPTE . 

(2) FRETURN ( ' SPC ' , 137) unless SPT[SPTX] is controlled by 
CSP. 

(3) FRETURN ( 'SPM', 100) unless 

(a) BYTESIZE(MAP) is 12 or 24, and 

(b) £ LENGTH(MAP) < LM, where LM = 32 if SPTX is a 
utility sub-process or 64 if it is a user sub- 
process. 

(4) FRETURN ( 'SPM 1 , 101) unless the PMT index field, PMTX, 
of every byte in MAP satisfies at least one of the 
following conditions. 

(a) PMTX = 0. 

(b) PMTX is identical with the PMT index currently in 
the corresponding byte of MAP (SPTX) . 

(c) 1 £ PMTX £ NPMTE and CSP has access to PMT [PMTX] . 
Action: 

If SPTX = -1, the map referred to is that of CSP. 

The bytes of MAP are used to set the . . < .••• 
first LENGTH(MAP) PMT indices of SPT [SPTX] and the corres- 
ponding READ ONLY BITS. The remaining PMT. indices and 
READ ONLY BITS are cleared. Each byte of MAP is expected 
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SET ' MAP ( continued) 

to contain a PMT index, PMTX, and a road only bit, RO . 

If BYTESIZE(MAP) is 12, RO is tak*»n from bit of the 
bytes and PMTX is taken from bits 4-1.1. If BYTESIZE(MAP) 
is 24, RO is taken from bit 12 and PMTX from bits 16-23. 

If SPTX is the current sub-process in either the User 
or Utility ring, the process Map is updated to correspond 
to the new MAP (SPTX) and the Physical Map is cleared. 
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READ 'MAP 'BYTE - Read a Byte in the Map of an SPT Entry 

Declaration: 

FUNCTION READ 'MAP' BYTE (SPTX, BYTENO) , FRETURN, MONITOR -101; 
Success Return: 

RETURN BYTE; where BYTE contains in bits 16-23 the BYTENO t] " 
PMT index from the MAP of SPT [SPTX], and in 
bit 12 the corresponding READ ONLY BIT. 
Failure Returns: 

(1) FRETURN ( 'SPI' , 138) unless 1 £ SPTX < NSPTE . 

(2) FRETURN (' MBN ' , 163) unless 
■_: BYTENO £ LM, where LM = 31 if SPTX is a utility 
sub-process or 63 if it is a user sub-process. 

Action: 

SPTX is used to select an entry in SPT (-1 selects 
CSP's entry) and BYTENO to choose a PMT index from the 
entry's map. The value of the MCALL is a word with this 
PMT index an bits 16-23 and the corresponding READ ONLY 
BIT in bit 12 . 
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SET 'MAP' BYTE - Set a Byte in the Map of an SPT Entry 

Declaration: 

FUNCTION SET' MAP' BYTE (SPTX, BYTENO, BYTE), FRETURN, 

MONITOR «- 102; 
Success Return: 

RETURN; 
Failure Returns: 

(1) FRETURN ( 'SPI', 138) unless 1 £ SPTX < NSPTE . 

(2) FRETURN ( ' SPC ' , 137) unless SPT[SPTX] is controlled by 
CSP. 

(3) FRETURN ( 'MBN', 163) unless 

£ BYTENO £ LM, where LM = 31 if SPTX is a utility 
sub-process or 63 if it is a user sub-process. 

(4) FRETURN ( ' SPM * , 101) unless the PMT index, PMTX, in 
BYTE satisfies at least one of the following condi- 
tions 

(a) PMTX = 0. 

(b) PMTX is identical with the PMT index currently in 
the byte of MAP (SPTX) selected by BYTENO. 

(c) 1 < PMTX <£ NPMTE and CSP has access to PMT [PMTX] . 
Action: 

If SPTX = -1, it is taken to refer to CSP. 

The byte of MAP (SPTX) selected by BYTENO is set from 
bits 16-23 of BYTE and the corresponding READ ONLY BIT is 
set from bit 12 . 

If SPTX is the current sub-process in either the User 

or Utility ring, the process Map is updated to correspond 
to the new MAP (SPTX) and the physical Map is cleared. 
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READ 'ACCESS 'KEY - Read an Access Key from an SPT Entry 



C 



Declaration: 

LONG FUNCTION READ 'ACCESS 'KEY ( SPTX, KEYNO) , FRETURN, 

MONITOR *- 103; 
Success Return: 

RETURN AKY; where AKY is the value of the access key se- 
lected by SPTX and KEYNO. 
Failure Returns: 

(1) FRETURN( 'SPI', 138) unless 1 £ SPTX £NSPTE; 

(2) FRETURN( 'ARC, 166) if KEYNO is not' an acceptable Ac- 
cess Key specification (see below) . 

Action: 

SPTX is used as an index to select an entry in SPT. 
SPTX = -1 selects the entry corresponding to the current 
sub-process. KEYNO selects one of the four access keys 
in SPT [SPTX] according to the following. 

KEYNO Access Key Selected 

or 'TAK' TEMPORARY ACCESS KEY (TAK) 



1 or 'UNO' 

2 or 'PKl' 

3 or * PK2 * 



USER NUMBER (UNO) 

PERMANENT ACCESS KEY 1 (PAK1) 

PERMANENT ACCESS KEY 2 (PAK2) 



The (48-bit) access key is returned as the value of 
the MCALL. 
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COPY' ACCESS' KEY -Copy an Access Key from one SPT Entry to 

Another 



C 



C 



Declaration: 

FUNCTION COPY' ACCESS' KEY(SPTXl, SPTX2, KEYl, KEY2), 

FRETURN, MONITOR «- 104; 
Success Return: 

RETURN; 
Failure Returns: 

(1) FRETURN ( 'SPI ', 138) unless SPTXl and SPTX2 are in the 
interval [1, NSPTE] . 

(2) FRETURN( ' SPC ' , 143) unless the calling sub-process, 
CSP, controls both SPT [SPTXl] and SPT[SPTX2] . 

(3) FRETURN( 'ARG', 166) unless KEYl and KEY2 are accept- 
able access key selectors. See the description of 
READ 'ACCESS* KEY for an explanation of how these argu- 
ments are interpreted. 

Action: 

This MCALL sets the access key selected by SPTX2 and 
KEY2 from the one selected by SPTXl and KEYl. SPTXl and 
SPTX2 are used as SPT indices, with the usual convention 
that when -1 is offered as an SPT index, it refers to the 
SPT entry for the current sub-process. KEYl and KEY2 se- 
lect one of the four access keys in SPT [SPTXl] and 
SPT[SPTX2] in exactly the same way that KEYNO selects an 
access key in the function READ 'ACCESS 'KEY. 
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COPY'TAK - Copy TEMPORARY ACCESS KEY 



Declaration: 

FUNCTION COPY'TAK( ), FRETURN, MONITOR «- 105; 

Success Return: 
RETURN; 

Failure Returns: 

(1) FRETURN( 'CNA' , 174) unless the CAKF flag is set in the 
SPCS entry at stack level -1. 

Action: 

This MCALL copies the TEMPORARY ACCESS KEY of the sub- 
process which called the current sub-process into the 
TEMPORARY ACCESS KEY field of the current sub-process . 
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Format of an Entry in SPT 




STATUS BITS (SB) 



TRAP MASK (TM) 



STATUS CONTROL BITS CSCB) 



TRAP CONTROL MASK (TCM) 



TEMPORARY ACCESS KEY 
(TAK) 



USER NUMBER 
(UNO) 



PERMANENT ACCESS KEY 1 
(PAK1 ) 



PERMANENT ACCESS KEY 2 
(PAK2) 



UNIQUE NAME OF 
UTILITY SUB-PROCESS 
(USPUN) 



READ ONLY BITS 



1 516 



~W 



PMT INDEX 1 



1 5 



PMT INDEX 2 



23 



23 



23 



23 



23 



23 



23 



23 



23 



23 



23 



23 



23 



23 



23 



23 



PMT INDEX 



1 6 



23 



PMT INDEX 3 



41 







PMT INDEX 61 



718 1 5tt 6 2 3 

PMT INDEX 62 PMT INDEX 63 



Figure 1 
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C 



PRP 
SYS 

940M - 
DPNIC - 

DPNIM - 

WFI 



DCWSO - 



DDWSO 



DPNOD - 



MSP 



SD 



Sub-process is a proprietary program 

Sub-process has system privileges 

Sub -process runs in 940 Mode 

The system is to automatically put referenced 

pages into the Core Working Set 

The system is to create new pages when the 

sub-process refers to pages not in its map 

The sub-process is allowed to open files for 

output in certain cases where this is not 

normally allowed 

The system is to automatically correct Core 

Working Set Overflow 

The system is to automatically correct Drum 

Working Set Overflow 

The system is to automatically put referenced 

pages into the Drum Working Set 

The sub-process has Master Sub-Process 

privileges 

The sub-process has System Diagnostic 

privileges 



Figure 2 
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Format of TM and TCM Fields in SPT 









1 


S 


3 


'4 


5 


6 


7 


P 


9 


10 


1 1 


12 


1 3 


14jl 5 


<"6 23 






M 




P 


P 








I 


P 


D 


c 




D 


N 


S 


P 










A 


P 


N 


N 


P 


T 


B 


L 


N 


V 


w 


N 


M 


I 


P 


M 










C 


R 


I 


I 


I 


I 


L 


I 





S 


s 


E 


R 


L 


C 


T 










C 





M 


C 






L 


M 


D 








P 


D 


E 


s 













MACC 


- Memory Access Trap 






PRO 


- Page Read Only Trap 






PNIM 


- Page Not in Map Trap 






PNIC 


- Page Not in Core Trap 






PI 


- Privileged Instruction Trap 






TI 


- Trapped Instruction Trap 






BLL 


- BLL error 






ILIM 


- Indirection Limit Exceeded 






PNOD 


- Page Not on Drum Trap 






DWSO 


- Drum Working Set Overflow 






CWSO 


- Core Working Set Overflow 






NEP 


- Non-Existent Page 






DMRD 


- Drum Read Error 






NILE 


- Non-interruptability Limit Exceeded 






SPCSO 


- Sub-Process Call Stack Overflow 






PMTO 


- Process Memory Table Overflow 
Figure 3 
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Normal Format of an SPCS Entry 




SAVED P-COUNTER (PC) 



SAVED L-REGISTER <LR) 



SAVED G-REGISTER (GR) 



NON-INTERRUPTABILITY 
EXPIRATION TIME 
(NIET) 



23 



23 



23 



23 



23 



L 



NIS - Non-interruptability set 

NIC - Non-interruptability copied from calling 

sub-process 
SPNO - Index of SPT entry which defines this 

sub-process 
CAKF - Copy caller's Temporary Access Key 
CC - Call Completed 
NIET - Real time at which non-interruptability 

status will expire 



Figure 4A 
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I 


p 


5 6~\^ ^1"3 


14 


23 


N 


N 












I 


I 


SPNO 




EPNO 




S 


C 















1 


e 




23 


c 










A 


C 




FIRST PARAMETER (PARI) 




K 


c 




* 




F 













SECOND PARAMETER (PAR2) 


23 


V 


1 




23 


£ 




NON-INTERRUPTA 
EXPIRATION T 


BILITY 







IME 


23 




(NIET) 





c 



NIS - Non-interruptability set 

NIC - Non-interruptability copied from calling 

sub -process 
SPNO - Index of SPT entry which defines this 

sub-process 
EPNO - Entry point Number 

CAKF - Copy Caller's Temporary Access Key 
CC - Call Completed 
PARI - Interrupt or trap number 
PAR2 - Trap parameter 
NIET - Real time at which non-interruptability 

status will expire 



Figure 4B 
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Appendix A: 












SPS MCALLs in Numeric Order 


Number 




Name 


Page 


90 


- 


CREATE ' SP 


17 


91 


- 


DESTROY' SP 


19 


92 


- 






93 


- 






94 


- 






95 


- 


READ ' SPT 


34 


96 


- 


READ'SPCS 


35 


97 


- 


READ 'SPT' FIELD 


36 


98 


- 


SET 'SPT 'FIELD 


38 


99 


- 


READ' MAP 


42 


100 




SET' MAP 


43 


101 


- 


READ ' MAP ' BYTE 


45 


102 


- 


SET' MAP' BYTE 


46 


103 


- 


READ' ACCESS' KEY 


47 


104 


- 


COPY 'ACCESS 'KEY 


48 


105 


- 


COPY'TAK 


49 


106 


- 






107 


- 






108 


- 






109 


- 






110 


- 






111 


- 


SP'CALL 


21 


112 


- 


SP'JUMP 


23 


. 113 


- 


SP'TRAP 


25 






c 



Appendix A 
Number 
114 
115 
116 
117 
118 



(continued) 

Name 
TRAP ' RETURN 
SP' BRANCH 
SP' RETURN 
JUMP ' RETURN 
MARK' CALL 




Page 
27 
28 
30 
31 
32 
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Appendix B: 



Error Codes Returned by SPS MCALLs 



C 



'ARC - Argument value unacceptable 

'CNA' - Call not allowed 

'CSE' - Call stack (SPCS) empty 

'CSL' - Call stack (SPCS) level out of bounds 

' EPN' - Entry point number illegal 

'FHL' - Fatherhood loop in SPT 

'MBN' - Map byte number out of bounds 

'MNM' - Modify sub-process NAME 

■MRG' - Modify sub-process RING 

'MSB' - Modify STATUS BITS 

*MSC' - Modify STATUS CONTROL BITS 

'MTC' - Modify TCM 

'MTM* - Modify TM 

'MUS' - Modify sub-process USP 

•RCS* - Room on SPCS 

•RNG' - Ring error 

'SPA' - Sub-process access needed 

' SPC' - Sub-process control needed 

•SPP« _ SPT (or SPT entry) full 

'SPI' - SPT index out of bounds 

'SPM' - Sub-process map 

'SPS' - Sub-process on call stack 

'TNO* - Trap number out of bounds 



# * * V 



r 
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Appendix C: 






Error Message Numbers Returned by SPS MCALLs 


100 


- 


byte size or length of string descriptor to SET'MAP 


101 


- 


value of byte offered to SET'MAP unacceptable 


103 


- 


attempt to acquire occupied SPT entry 


137 


- 


attempt to set map of uncontrolled sp 


138 


- 


SPT index out of bounds 


139 


- 


trap number out of bounds 


140 


- 


attempt to call inaccessible sp 


141 


- 


not enough room on SPCS for SP'CALL or MARK 'CALL 


142 


- 


attempted SP' BRANCH on uncontrolled sp 


143 


- 


attempt to set uncontrolled SPT entry 


144 


- 


attempt to modify uncontrolled STATUS BITS 


145 


- 


attempt to modify uncontrolled SCB bits 


146 


- 


attempt to modify uncontrolled TCM bits 


147 


- 


attempt to modify uncontrolled TM bits 


148 


- 


attempt to set uncontrolled bits in sp KEY 


149 


- 


attempt to set FATHER to uncontrolled sp 


150 


- 


attempt to create FATHERhood loop in SPT 


151 


- 


lack of room on SPCS forbids setting FATHER 


152 


- 


attempted SP' RETURN from empty stack 


153 


— 


call stack level for JUMP* RETURN or READ 'SPCS out of 
bounds 


154 


- 


attempt to JUMP 'RETURN over un-controlled sub-process 


155 


- 


offered P,L,G for MARK' CALL violate ring restrictions 


157 


- 


offered EP or EG violates ring restriction 


160 


- 


attempt to delete un-controlled SPT entry 



f 4 * Jk 



c 
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Appendix C ( continued) 



C 



161 - attempt to delete SPT entry which appears on SPCS 

162 - atteirpt to commit suicide when SPCS empty 

163 - map byte number out of bounds 

165 - unacceptable parameter code offered to READ 'SPT 'FIELD 

166 - unacceptable access key code (READ/COPY 'ACCESS 'KEY) 

167 - unacceptable parameter code offered to SET 'SPT 'FIELD 

168 - attempt to modify the NAME of a sub-process 

170 - attempt to modify the USP of a sub-process 

171 - attempt to modify the RING of a sub-process 

172 - offered value for CAKF is neither nor 1 

173 - illegal entry point number (SP'CALL or SP'JTJMP) 

174 - un-authorized call on COPY'TAK 



C 



